26.5 Das »DataSet«-Objekt 

26.5.1 Allgemeines 

Wäre man gezwungen, eine Rangfolge der ADO.NET-Typen nach ihrer Wichtigkeit aufzustellen, würde DataSet zweifelsfrei an erster Position stehen. Diese Klasse bildet den Kern von ADO.NET, um den herum sich fast alles andere rankt.

Ein DataSet ist in erster Linie ein Container – ein Container für eine oder auch mehrere Tabellen, die sich im lokalen Datenspeicher befinden. Um welche Tabellen einer Datenbank es sich handelt und welche Datenzeilen in den Tabellen enthalten sind, wird durch das Command-Objekt beschrieben, dessen Referenz die Eigenschaft SelectCommand des DataAdapters enthält. Zwischen den Tabellen in einem DataSet können Beziehungen eingerichtet werden, genauso wie im Original. Damit ist ein DataSet ein temporäres Abbild der Originaldatenbank – zumindest ein Ausschnitt davon.

Der verbindungsorientierte DataReader mag zwar in manchen Situationen den Anforderungen genügen, aber er ist nicht sehr flexibel. Zwischen den Datenzeilen kann nicht beliebig navigiert werden, Datenzeilen können nicht verändert werden – ganz zu schweigen von einer Suche nach bestimmten Datensätzen, einer Sortierung oder Filterung. Mit anderen Worten: Sollen Daten nicht nur angezeigt, sondern in irgendeiner Art und Weise bearbeitet werden, führt praktisch kein Weg am DataSet vorbei.

26.5.2 Ein »DataSet«-Objekt erzeugen 

Die Klasse DataSet befindet sich, wie viele andere Klassen, die nicht providerspezifisch sind, im Namespace System.Data. In den meisten Fällen ist der parameterlose Konstruktor vollkommen ausreichend, um ein DataSet-Objekt zu erhalten.

Soll das DataSet einen Namen erhalten, bietet sich alternativ der einparametrisierte Konstruktor an:

Der Name kann auch über die Eigenschaft DataSetName festgelegt oder abgerufen werden.

26.5.3 Das DataSet füllen 

Zum Leben erweckt wird ein DataSet-Objekt nicht durch die Instanziierung der Klasse, sondern vielmehr durch den Aufruf der Fill-Methode des DataAdapters.

Das Ergebnis der Abfrage enthält alle Datensätze der Tabelle authors. Diese Datensätze sind in einer Tabelle enthalten, die durch ein DataTable-Objekt beschrieben wird.

26.5.4 Tabellen- und Spaltenbezeichner zuordnen 

Um ein DataSet gleichzeitig mit mehreren Tabellen zu füllen, können wir eine Batch-Abfrage absetzen, z.  B.:

Das DataSet beherbergt nun drei Tabellen im lokalen Speicher. In jeder Tabelle sind alle Datensätze der entsprechenden Originaltabelle authors, titles und titleauthor enthalten. Wir könnten nun jeder lokalen Tabelle Datensätze hinzufügen, Datensätze löschen oder ändern. Alle Änderungen werden bei einer erneuten Verbindungsaufnahme unter Aufruf der Update-Methode des DataAdapters in die Originaldatenbank zurückgeschrieben.

Allerdings stehen wir zuvor vor einer Frage: Wie kann ich eine bestimmte Tabelle im DataSet ansprechen, wenn darin mehrere Tabellen enthalten sind? Denn um einen Datensatz zu bearbeiten, muss zuvor festgelegt werden, in welcher Tabelle der entsprechende Datensatz zu finden ist.

Ein DataSet verwaltet alle in ihm enthaltenen Tabellen in einer Auflistung vom Typ Data-TableCollection. Die Referenz auf diese Auflistung liefert die Eigenschaft Tables des DataSet-Objekts.

Der Zugriff auf eine Tabelle im DataSet erfolgt über den Index der Auflistung, dem entweder der Verwaltungsindex der Tabelle oder der Bezeichner der Tabelle übergeben werden kann, z.  B.:

ds.Tables(0)

Jetzt sollte man auch noch wissen, dass ein DataTable-Objekt seinen Tabellennamen über die Eigenschaft TableName preisgibt. Mit diesen Kenntnissen können wir jetzt die Namen der Tabellen im DataSet abfragen:

Die Ausgabe wird nicht – wie vielleicht zu vermuten wäre – authors, titleauthor und titles lauten, sondern:

Die Zuordnung von Table zu authors, Table1 zu titleauthor und Table2 zu titles ist in den meisten Fällen nicht wünschenswert. Der DataAdapter bietet daher einen Mechanismus, um den Tabellen im Abfrageergebnis einen anderen Namen zuzuordnen: die Eigenschaft TableMappings, welche die Referenz auf ein DataTableMappingCollection-Objekt liefert.

In der Auflistung DataTableMappingCollection werden Objekte vom Typ DataTableMapping verwaltet. Jedes dieser Objekte ordnet einer Tabelle im DataSet einen Tabellennamen zu.

Am einfachsten ist es, mit der Add-Methode die Auflistung zu füllen.

Dazu wird dem ersten Parameter die Zeichenfolge übergeben, unter der die Tabelle per Vorgabe in das DataSet gefüllt wird, dem zweiten Parameter teilt man den gewünschten Tabellennamen mit, unter dem die Tabelle im Code angesprochen wird.

Das folgende Codefragment zeigt, wie Sie die DataTableMappingCollection des DataAdapter-Objekts füllen können. Dabei wird davon ausgegangen, dass die oben angeführte Batch-Abfrage abgesetzt wird. Die Zuordnung muss vor dem Füllen des DataSets mit Fill erfolgen, ansonsten bleibt sie wirkungslos.

Add ruft implizit den DataTableMapping-Konstruktor auf. Sie können das natürlich auch selbst in die Hand nehmen, müssen dann aber jeder Tabelle über die Eigenschaft SourceTable sagen, welchen Standardnamen sie im DataSet hat, und über DataSetTable, welcher Bezeichner der Tabelle neu zugeordnet werden soll. Das folgende Beispiel zeigt, wie der Code dazu aussieht.

Die Klasse DataTableMapping gehört zum Namespace System.Data.Common. Deutlich ist zu sehen, dass diese Art der Zuordnung mehr Programmieraufwand bedeutet. Daher steht vermutlich außer Frage, welcher Variante Sie den Vorzug geben.

Spaltenzuordnungen in einem DataSet

Jeder Spalte der SELECT-Abfrage wird eine Spalte in der DataTable zugeordnet. Als Spaltenbezeichner verwendet ADO.NET dabei den Spaltennamen der Originaltabelle in der Datenbank. Fragen Sie die Datenquelle mit

ab, lauten die Spalten in der DataTable ebenfalls au_lname, au_fname und city. Wünschen Sie andere Spaltenbezeichner, können Sie im SELECT-Statement für die einzelnen Spalten einen Alias angeben, z.  B.:

Nun würden in der DataTable die Spaltenbezeichner Zuname, Vorname und Stadt lauten.

Sie können alternativ auch einen anderen Mechanismus einsetzen. Ein DataTableMapping-Objekt hat eine eigene Auflistung, mit der den obligatorischen Spaltenbezeichnern neue zugeordnet werden können. Diese Auflistung ist vom Typ DataColumnMappingCollection und enthält DataColumnMapping-Objekte. Jedes dieser Objekte beschreibt für sich eine Neuzuordnung eines Spaltenbezeichners in einer DataTable. Die vielleicht ein wenig komplex anmutenden Zusammenhänge zwischen DataAdapter, DataTableMapping und DataColumnMapping sind in Abbildung 26.8 anschaulich dargestellt.

Hier klicken, um das Bild zu Vergrößern

Abbildung 26.8     Die Hierarchie der Zuordnungsklassen

Die Referenz auf die DataColumnMappingCollection stellt die Eigenschaft ColumnMappings der Klasse DataTableMapping bereit:

Um eine Neuzuordnung festzulegen, bietet sich auch hier der Weg über die Add-Methode des DataColumnMappingCollection-Objekts an.

Analog zur Add-Methode der DataTableMappingCollection wird dem ersten Parameter der ursprüngliche Spaltenbezeichner, dem zweiten Parameter der gewünschte übergeben.

Das folgende Codefragment zeigt den kompletten Code, der notwendig ist, um neben dem Tabellennamen auch die Spaltenbezeichner einer Abfrage neu festzulegen. Zum Schluss werden die Spaltenneuzuordnungen zur Bestätigung an der Konsole ausgegeben. Der Code im Schleifenkopf zur Ausgabe der Spaltenbezeichner dürfte zwar auch ohne weitere Erläuterungen verständlich sein. Wir werden aber dennoch an anderer Stelle darauf zurückkommen.

Spaltenzuordnungen einer DataTable

Übergeben Sie der Fill-Methode anstelle eines DataSet- ein DataTable-Objekt, müssen Sie ein wenig anders vorgehen, um die Spalten mit eigenen Bezeichnern im lokalen Datenspeicher anzusprechen. Dazu erzeugen Sie auch wieder ein DataTableMapping-Objekt, dem Sie die gewünschten Spaltenbezeichner zuordnen. Bei der Instanziierung von DataTable rufen Sie allerdings den parametrisierten Konstruktor auf, dem der im DataTableMappping zugeordnete Tabellenname übergeben wird.

Die Eigenschaft »MissingMappingAction« des DataAdapters

Die Neuzuordnung der Tabellen- und Spaltenbezeichner ist eine Option, die vor dem Aufruf der Methode Fill wahrgenommen werden kann oder nicht. Der DataAdapter prüft vor dem Füllen des DataSets, ob die Zuordnungsauflistungen gefüllt sind. Dabei interessiert er sich besonders für die Spaltenzuordnungen.

Für jede Spalte des Abfrageergebnisses überprüft der DataAdapter zuerst, ob dafür eine Zuordnung in der DataColumnMappingCollection angegeben ist. Existiert eine solche nicht, überprüft er im nächsten Schritt seine MissingMappingAction-Eigenschaft. Hier findet er die Antwort darauf, wie er mit einer fehlenden Spaltenangabe umzugehen hat.

Standardmäßig werden Spalten, die nicht im DataColumnMapping-Objekt angegeben sind, mit dem Namen, den sie in der Originaltabelle haben, in die entsprechende DataTable eingetragen. Der DataAdapter kann aber auch angewiesen werden, alle Spalten, die nicht in der Zuordnungstabelle enthalten sind, zu ignorieren. Eine dritte Möglichkeit ist, eine Ausnahme auszulösen, wenn keine Zuordnung angegeben ist.

Die Eigenschaft MissingMappingAction teilt dem DataAdapter mit, wie er zu verfahren hat. Diese Eigenschaft ist vom Typ der gleichnamigen Enumeration MissingMappingAction.

Die drei Member der Enumeration lauten Error, Ignore und Passthrough. Letztere ist die Standardeinstellung.